*****************************************************
* MoxCdBurn 0.2.0 Copyright (c) 2005 Michele Moccia *
*****************************************************
E-Mail : takeshi@iol.it

TABLE OF CONTENTS
-----------------
1. Introduction
2. Comments
3. Windows 95/98/ME notes
4. Windows NT4/2000/XP notes
5. Functionalities
6. Supporting me
7. License



1. INTRODUCTION :
-----------------

MoxCdBurn is a free open source library that adds cd writing
feature to a program. It can be implemented as C++ class 
or with ActiveX Control version that wraps the C++ class. In 
particular the C++ class can be directly implemented with
source files or linking the static lib version (i suggest the
first way).



2. COMMENTS :
-------------

This is the very first version i' m releasing. The libray features 
are still so little, especially the ability of write only already 
maded iso image file, make it not usefull for the moment. 

This is the second version i'm releasing. The most important new
feature is the possibility to create ISO9660 image files. That let
to perform complete backup operations. Anyway the joliet extension
isn't still supported, so file names could result with a different
form, dues to restricted ISO9660 character set.
To know which will be the final version features look at todo.txt file.
The main development difficult of this kind of library is support
a wide range of cd writer model with much possible windows 
version. At this stage MoxCdBurn supports only full SCSI-MMC 
compliant drive. Anyway i tested it on a few model so 
there' s no working warranty on any drive model.



3. WINDOWS 95/98/ME NOTES :
---------------------------

Win 9x hasn't a native interface that supports comunication
between applications and scsi devices. It comes with ASPI
interface from Adaptec. ASPI works with Atapi devices too.
The standard ASPI version distributed with windows works well
in the major cases. If you updated the ASPI layer on your
system you could have some problem, especially with Atapi 
devices. In this case check and eventually add the following 
key in the registry:

[HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\APIX]  
"ExcludeMiniports"=""



4. WINDOWS NT4/2000/XP NOTES :
-----------------------------

Win NT4/2000/XP use SPTI (Scsi Pass Through Interface) interface to
let applications comunicate to SCSI and Atapi devices. MoxCdBurn
uses it by default, but it's possible to force the ASPI usage. In
this case last version of ASPI layer could have some problem, 
especially with Atapi devices. In this case check the following 
keys in the registry:

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ASPI32]  
"ErrorControl"=dword:00000001  
"Start"=dword:00000001  
"Type"=dword:00000001  
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ASPI32\Parameters]  
"ExcludeMiniports"=""  

The application using MoxCdBurn with Win NT4/2000/XP needs
amministrative rights.



5. FUNCTIONALITIES :
--------------------

- Support ASPI and SPTI interface

- Scan system for all cdrom unit

- Retrieve drive data including drive letter

- Get all supported target drive capabilities

- Detect if media is currently loaded in the cdrom unit

- Open tray to eject media

- Lock or unlock cdrom unit

- Get disc type (cd audio data, cdi, cdxa, etc.)

- Get disc physical format (cdr, cdrw, cd readonly)

- Get write and read speed value in multiplier factor

- Get current disc session status (empty, completed, incomplete)

- Set write speed for next writing operation

- Perform disc erasing in fast or entire mode. This operation can
  be done in syncronous or asyncronous mode. Second trigger events 
  with thread or window messages
  
- Write iso image file. This operation can be done in syncronous 
  or asyncronous mode. Second trigger events with thread or 
  window messages
  
- Abort write operation (for async mode only)

- Debug mode to stdout or file output with low level scsi commands

- Wide error signalation support

- ActiveX Control version

- Create iso9660 compliant image file. This operation can
  be done in syncronous or asyncronous mode. Second trigger events 
  with thread or window messages (NEW)
  
- Retrieve statistics from virtual iso9660 image file



6. SUPPORTING ME :
------------------

I'm not a professionist developer and i do that in my free time.
Any help is welcome. If someone would want to help me in any
way may write to the e-mail address at the beginning of this
page.
If you detect working problems please mail to me indicating
you drive data (vendor - model - firmware), your o.s. and
if possible sending the file obtained with debug mode. You 
may do the same thing if the applications work correctly.
Cause my terrible english i really need someone that 
corrects documents that come with MoxCdBurn. Thank you



7. LICENSE :

MoxCdBurn is released under LGPL license. Sample programs are
released under GPL license. See COPYING files for more info.



Regards

Michele Moccia